Filter hook 'delete_{$meta_type}_metadata'

in WP Core File wp-includes/meta.php at line 428

Description

Short-circuits deleting metadata of a specific type. The dynamic portion of the hook name, `$meta_type`, refers to the meta object type (post, comment, term, user, or any other type with an associated meta table). Returning a non-null value will effectively short-circuit the function. Possible hook names include: - `delete_post_metadata` - `delete_comment_metadata` - `delete_term_metadata` - `delete_user_metadata`

Occurrences

Filename Line Number
wp-includes/meta.php 428

Parameters

Type Name Description
null|bool $delete Whether to allow metadata deletion of the given type.
int $object_id ID of the object metadata is for.
string $meta_key Metadata key.
mixed $meta_value Metadata value. Must be serializable if non-scalar.
bool $delete_all Whether to delete the matching metadata entries for all objects, ignoring the specified $object_id. Default false.

PHP Doc

/**
	 * Short-circuits deleting metadata of a specific type.
	 *
	 * The dynamic portion of the hook name, `$meta_type`, refers to the meta object type
	 * (post, comment, term, user, or any other type with an associated meta table).
	 * Returning a non-null value will effectively short-circuit the function.
	 *
	 * Possible hook names include:
	 *
	 *  - `delete_post_metadata`
	 *  - `delete_comment_metadata`
	 *  - `delete_term_metadata`
	 *  - `delete_user_metadata`
	 *
	 * @since 3.1.0
	 *
	 * @param null|bool $delete     Whether to allow metadata deletion of the given type.
	 * @param int       $object_id  ID of the object metadata is for.
	 * @param string    $meta_key   Metadata key.
	 * @param mixed     $meta_value Metadata value. Must be serializable if non-scalar.
	 * @param bool      $delete_all Whether to delete the matching metadata entries
	 *                              for all objects, ignoring the specified $object_id.
	 *                              Default false.
	 */